home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / admin.fmt / boot.man < prev    next >
Text File  |  1991-10-28  |  13KB  |  333 lines
  1.  
  2.  
  3.  
  4. BOOT                 Administrative Commands                 BOOT
  5.  
  6.  
  7.  
  8. _________________________________________________________________
  9.  
  10. NNAAMMEE
  11.      boot - Description of Sprite boot options and behavior
  12.  
  13. OOPPTTIIOONNSS
  14.      There are a number of boot  options  that  can  be  used  to
  15.      change  the  boot  behavior.  If you are unfamiliar with the
  16.      booting process you  should  read  the  subsequent  sections
  17.      before this one.
  18.  
  19.      --cc             Causes a fileserver to ignore  the  existence
  20.                     of  /bootTmp/boot  and to boot as a dependent
  21.                     fileserver.  This  is  useful   for   booting
  22.                     fileservers with trashed disks.
  23.  
  24.      --ff             Causes a fileserver to boot without  checking
  25.                     its  disks.  This can lead to corrupted disks
  26.                     if the disks are not consistent  before  they
  27.                     are  attached.  The  --ff  option should not be
  28.                     used if the system halted abnormally.
  29.  
  30.      --ss             The --ss option causes the machine to  boot  in
  31.                     single-user  mode.   A  login shell is run by
  32.                     initsprite before both diskcmds and bootcmds.
  33.                     Initsprite will continue when the login shell
  34.                     exits.
  35.  
  36.      --xx             If the machine is a fileserver  it  will  run
  37.                     /boot/rootcmds  after running /boot/diskcmds.
  38.                     This option allows a non-root  fileserver  to
  39.                     serve  as root.  Only the root fileserver has
  40.                     the correct mount table for exporting "/"  --
  41.                     the rootcmds file contains the necessary com-
  42.                     mands for allowing a non-root  fileserver  to
  43.                     export "/".
  44.  
  45. _________________________________________________________________
  46.  
  47. DDEESSCCRRIIPPTTIIOONN
  48.      The first couple sections of this  man  page  are  a  user's
  49.      guide  to  booting  Sprite.   Note  that  these  are general
  50.      instructions; each file  server  should  have  its  specific
  51.      booting instructions posted near its console.
  52.  
  53.      The rest of the man page goes into  more  detail  about  the
  54.      boot  process and is probably of interest only to people who
  55.      hack Sprite.
  56.  
  57. BBOOOOTTIINNGG SSUUNNSS
  58.      For all Suns except SPARCstation 2's the boot command  typed
  59.      at the PROM has the format
  60.  
  61.           bb _x_x((_a,_b,_c))_k_e_r_n_e_l [_o_p_t_i_o_n_s]
  62.  
  63.  
  64.  
  65. Sprite v.1.0       Printed:  October 28, 1991                   1
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72. BOOT                 Administrative Commands                 BOOT
  73.  
  74.  
  75.  
  76.      For machines that are booted off of the network _x_x  is  usu-
  77.      ally iiee or llee, depending on whether the machine has an Intel
  78.      or Lance ethernet chip.  For machines that  boot  off  their
  79.      disk,  _x_x is usually ssdd.  For SPARCstation 2's the boot com-
  80.      mand is
  81.  
  82.           bb [_d_e_v_i_c_e] _k_e_r_n_e_l [_o_p_t_i_o_n_s]
  83.  
  84.      where _d_e_v_i_c_e is usually nneett or ddiisskk.  (For SPARCstation  2's
  85.      running  Sprite  at  Berkeley,  _d_e_v_i_c_e  normally defaults to
  86.      nneett.)
  87.  
  88.      The magic  numbers  _a,  _b,  _c  in  parentheses  are  usually
  89.      optional.  They specify information about the host that sup-
  90.      plies the kernel (for booting off the net), disk  partition,
  91.      etc.   For  network  booting,  the middle number is the last
  92.      four digits of the IP address of the server.  You only  need
  93.      to  specify  this  number  if the default doesn't work.  For
  94.      example, to ensure that Murder boots  off  of  Allspice  (IP
  95.      address 128.32.150.27), use
  96.  
  97.           bb llee((00,,996611bb))ssuunn33..mmdd//sspprriittee
  98.  
  99.      and to boot off of Ginger (IP address 128.32.150.28), use
  100.  
  101.           bb llee((00,,996611cc))ssuunn33..mmdd//sspprriittee
  102.  
  103.      The string _k_e_r_n_e_l tells which kernel to load and boot.  When
  104.      booting  off  a disk, _k_e_r_n_e_l is usually just the name of the
  105.      kernel, e.g., ``new'' or ``sprite''.  When booting  off  the
  106.      net,  you  must also specify the machine-dependent directory
  107.      that the kernel is found  in,  e.g.,  ``sun3.md/new''.   Use
  108.      ssuunn33..mmdd  for  Sun 3's, ssuunn44..mmdd for Sun 4's, and ssuunn44cc..mmdd for
  109.      SPARCstation 1's and 2's.
  110.  
  111. BBOOOOTTIINNGG DDSS33110000''ss
  112.      The basic boot command for a DECstation 3100 is
  113.  
  114.           bboooott --ff _p_r_o_t_o(())_k_e_r_n_e_l [_o_p_t_i_o_n_s]
  115.  
  116.      where _p_r_o_t_o is either ttffttpp or mmoopp.  Generally  mmoopp  is  pre-
  117.      ferred,  since  it  is  faster  and  more  reliable.  Unfor-
  118.      tunately, it provides no feedback until  the  kernel  starts
  119.      running,  so  you  have  to put up with a 10-30 second pause
  120.      before there's any sign of life.
  121.  
  122.      The _k_e_r_n_e_l string depends on whether  the  DECstation  knows
  123.      what  server  to  use.   The simplest rule is to always type
  124.      iinniitt to the PROM before booting, and  use  only  the  kernel
  125.      name (e.g., ``sprite'' or ``new'') for _k_e_r_n_e_l.
  126.  
  127.  
  128.  
  129.  
  130.  
  131. Sprite v.1.0       Printed:  October 28, 1991                   2
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138. BOOT                 Administrative Commands                 BOOT
  139.  
  140.  
  141.  
  142. BBOOOOTTIINNGG DDSS55000000''ss
  143.      The boot command for a DECstation 5000 looks like
  144.  
  145.            bboooott _s_l_o_t//_x_x_x//_k_e_r_n_e_l [_o_p_t_i_o_n_s]
  146.  
  147.      The _s_l_o_t string is the slot  number  for  the  device  being
  148.      booted  from.   You can use the PROM's ccnnffgg command to get a
  149.      list of what devices are installed at  what  slots.   Sprite
  150.      DECstations  typically  have  two  ethernets  installed; you
  151.      should boot from the lower-numbered ethernet.
  152.  
  153.      The _x_x_x string is the protocol type when  booting  from  the
  154.      net.   Use  mmoopp.   It  is the disk name (e.g., ``rz0'') when
  155.      booting from the disk.
  156.  
  157.      The _k_e_r_n_e_l string is just the  name  of  the  kernel  (e.g.,
  158.      ``new'').
  159.  
  160. WWHHEERREE KKEERRNNEELLSS LLIIVVEE
  161.      Machines that boot off of their own disk  typically  have  a
  162.      small boot partition, such as /allspiceA or /lustA.  In this
  163.      case the kernel nneeww would be installed as /allspiceA/new.
  164.  
  165.      Kernels  that  are  downloaded  from  a  Sprite  server  are
  166.      installed in /sprite/boot (e.g., /sprite/boot/sun3.md/new).
  167.  
  168.      As a last resort kernels can also be downloaded from Ginger.
  169.      Those    kernels   are   installed   in   /tftpboot   (e.g.,
  170.      /tftpboot/sun3.md/new).  Suns that boot off of  Ginger  must
  171.      have  a  link  in  /tftpboot to their boot program.  See the
  172.      documentation for bboooott(8S) on Ginger.
  173.  
  174. BBOOOOTT SSEEQQUUEENNCCEE
  175.      WWAARRNNIINNGG:: This section is rather dated and is probably  inac-
  176.      curate in spots.
  177.  
  178.      This section outlines the sequence of events that occur dur-
  179.      ing  the boot process. The command typed at the prom is used
  180.      to start the downloader, then download the kernel  from  the
  181.      server  and  start  execution. The early part of the boot is
  182.      the same on all machines. Kernel data structures are set  up
  183.      and  kernel processes started.  Late in the boot the machine
  184.      checks for the presence of a disk, and it starts  the  first
  185.      user  process _i_n_i_t_s_p_r_i_t_e.  The actions initsprite takes vary
  186.      depending on the configuration of the  machine.   There  are
  187.      three standard machine configurations.  _C_l_i_e_n_t_s are diskless
  188.      workstations.  They are dependent on the root fileserver  to
  189.      complete  the  boot process.  Machines with disks must check
  190.      them during boot for inconsistencies.   Checking  the  disks
  191.      requires the _f_s_c_h_e_c_k and _f_s_a_t_t_a_c_h programs, and related data
  192.      files.  _S_t_a_n_d_a_l_o_n_e _f_i_l_e_s_e_r_v_e_r_s have these utilities on their
  193.      own  disk,  and  are  therefore  able  to  check their disks
  194.  
  195.  
  196.  
  197. Sprite v.1.0       Printed:  October 28, 1991                   3
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204. BOOT                 Administrative Commands                 BOOT
  205.  
  206.  
  207.  
  208.      without the root fileserver.  _D_e_p_e_n_d_e_n_t _f_i_l_e_s_e_r_v_e_r_s  have  a
  209.      disk,  but  it does not contain the needed files.  Dependent
  210.      fileservers must get these files from the root file server.
  211.  
  212.      Clients
  213.           /boot/initsprite is exec'ed as the first user  process.
  214.           If  "/"  is unavailable the workstation will wait inde-
  215.           finitely, checking  for  "/"  at  1  minute  intervals.
  216.           Initsprite  will  run  /hosts/_h_o_s_t_n_a_m_e/bootcmds  if  it
  217.           exists and /boot/bootcmds otherwise.
  218.  
  219.      Dependent fileservers
  220.           Fileservers will detect the  presence  of  a  disk  and
  221.           attach  it  as "/bootTmp".  This prefix is local to the
  222.           machine  and  is  not  exported.   If   the   directory
  223.           /bootTmp/boot is not found, then the fileserver assumes
  224.           it is  a  dependent  fileserver.   /boot/initsprite  is
  225.           exec'ed as the first user process.  Initsprite will run
  226.           /boot/diskcmds to verify that the disks  are  not  cor-
  227.           rupted.   The table used to mount the disks is found in
  228.           /hosts/$HOST/mount.  Upon completion the  machine  will
  229.           try  to  find a server of "/".  If no server for "/" is
  230.           found the workstation will retry at 1 minute intervals.
  231.           Once  a  server  is  found, /hosts/_h_o_s_t_n_a_m_e/bootcmds or
  232.           /boot/bootcmds is  run.   Initsprite  will  delete  the
  233.           "/bootTmp" prefix prior to exiting.
  234.  
  235.      Standalone fileservers
  236.           A  standalone  fileserver  will  attach  its  disk   as
  237.           /bootTmp  and  then  check  for  /bootTmp/boot.  Having
  238.           found this directory it will create a  new  prefix  "/"
  239.           using  the  /bootTmp  prefix.  These  prefixes  are now
  240.           synonyms and are local to the machine.  The  standalone
  241.           fileserver  can  then proceed with the boot in the same
  242.           manner as a dependent  fileserver.   /boot/diskcmds  is
  243.           run.  Unlike  a dependent fileserver, /boot/diskcmds is
  244.           on the machine's own disk.  The mount table is found in
  245.           /hosts/$HOST/mount, also on the machine's own disk.  At
  246.           some point in the boot the machine has  to  stop  being
  247.           its  own  server  of  "/" and look for the real server.
  248.           This happens after diskcmds has been run.  The  machine
  249.           will delete the "/" prefix and try to open "/".  If the
  250.           open fails the machine  will  try  again  at  1  minute
  251.           intervals.   Once "/" is found the appropriate bootcmds
  252.           is run.  Initsprite will delete the  "/bootTmp"  prefix
  253.           prior to exiting.
  254.  
  255. FFIILLEESS
  256.      /boot
  257.           /boot is a directory that contains all of the files and
  258.           utilities  needed to boot a Sprite machine.  Standalone
  259.           fileservers each have a /boot directory on their  local
  260.  
  261.  
  262.  
  263. Sprite v.1.0       Printed:  October 28, 1991                   4
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270. BOOT                 Administrative Commands                 BOOT
  271.  
  272.  
  273.  
  274.           disk and will use it during the boot process.
  275.  
  276.      /boot/cmds
  277.           Contains utility programs needed during boot.
  278.  
  279.      /boot/diskcmds
  280.           Run by fileservers to  check  their  disks.  Note  that
  281.           dependent  fileservers  run  the  diskcmds found on the
  282.           root fileserver.
  283.  
  284.      /hosts/_h_o_s_t_n_a_m_e/mount
  285.           The mount table read  by  fileserver  _h_o_s_t_n_a_m_e.   Stan-
  286.           dalone  fileservers  should  have a copy of their mount
  287.           table in /hosts/_h_o_s_t_n_a_m_e/mount on both the  local  disk
  288.           and the root fileserver.
  289.  
  290.      /boot/serverInfo
  291.           Provides machine name and  type  information  to  stan-
  292.           dalone   fileservers.   Standalone  fileservers  cannot
  293.           depend upon the root fileserver being able  to  provide
  294.           /etc/spritehosts  (the  usual place this information is
  295.           found) so they need their own file.   The  file  should
  296.           consist of the appropriate line from /etc/spritehosts.
  297.  
  298.      /boot/bootcmds
  299.           This file is unique to  the  whole  system.  Standalone
  300.           fileservers  DO  NOT look in their local /boot for this
  301.           file. bootcmds contains commands for  starting  various
  302.           user-level  servers and other system configuration com-
  303.           mands.
  304.  
  305.      /hosts/_h_o_s_t_n_a_m_e/bootcmds
  306.           If  this   file   exists   it   is   run   instead   of
  307.           /boot/bootcmds.
  308.  
  309.      /boot/rootcmds
  310.           This file contains the commands necessary for a  backup
  311.           root  server  to  actually  export root.  In the normal
  312.           case the file will contain the single line "prefix -x /
  313.           -l /bootTmp".
  314.  
  315. KKEEYYWWOORRDDSS
  316.      boot, bootcmds, diskcmds, rootcmds
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329. Sprite v.1.0       Printed:  October 28, 1991                   5
  330.  
  331.  
  332.  
  333.